home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
InfoMagic Standards 1994 January
/
InfoMagic Standards - January 1994.iso
/
iso
/
sc6_gmi.gdm
< prev
next >
Wrap
Text File
|
1991-12-16
|
19KB
|
499 lines
--Annex C
--Syntax Imported from ISO 10165-5 (SC6 GMI)
--(This annex is normative)
-- Generic Managed Object Class Definitions
MODULE "Rec. X.723 | ISO/IEC 10165-5"
-- Communication information record
-- The communicationsInformationRecord object class is used to define
-- the information stored in a log as a result of receiving event reports
-- with a communication information event type. The semantics of the
-- object class, namely its attributes and behaviour, are derived from
-- the communicationsInformation notification.
communicationsInformationRecord MANAGED OBJECT CLASS
DERIVED FROM "Rec. X.721 | ISO/IEC 10165-2 : 1992":eventLogRecord;
CHARACTERIZED BY communicationsInformationRecordP1 PACKAGE
BEHAVIOUR communicationsInformationRecordB1 BEHAVIOUR
DEFINED AS
!Log record class for communicationsInformation events.!;
;
ATTRIBUTES
informationType GET;
;;
CONDITIONAL PACKAGES
informationDataPackage PACKAGE
ATTRIBUTES
informationData GET;
REGISTERED AS {CommonMgt.poi informationDataPackage(1001)};
PRESENT IF !The informationData parameter is present in the
communicationsInformation event report corresponding to
the instance of communicationsInformationRecord.!;
REGISTERED AS {CommonMgt.moi communicationsInformationRecord(1101)};
-- Communications entity
-- Summary of changes to 10165-5:
-- 1. Added CCITT part to document references.
-- 2. Gave plural labels to set-valued attributes.
-- 3. Fixed typo in label communicationsEentityId.
-- 4. Did not register mandatory package.
communicationsEntity MANAGED OBJECT CLASS
DERIVED FROM "Rec. X.721 | ISO/IEC 10165-2 : 1992":top;
CHARACTERIZED BY communicationsEntityP1 PACKAGE
BEHAVIOUR
communicationsEntityB1 BEHAVIOUR
DEFINED AS
!A communications entity supports the disabled and enabled
values of the operationalState attribute as described in
CCITT Rec. X.731 | ISO/IEC 10164-2 as follows:
- an entity is disabled if it is inoperable or a resource
upon which it depends is inoperable.
- an entity is enabled if it is operable.!;
;
ATTRIBUTES communicationsEntityId GET,
localSapNames GET,
"Rec. X.721 | ISO/IEC 10165-2 : 1992":operationalState GET;
;;
REGISTERED AS {CommonMgt.moi communicationsEntity(1002)};
-- Connection
-- Summary of changes to 10165-5:
-- 1. Added CCITT part to document references.
-- 2. Gave plural label to set-valued attribute.
-- 3. Did not register mandatory package.
-- 4. Removed attributes not generally applicable in all layers.
connection MANAGED OBJECT CLASS
DERIVED FROM "Rec. X.721 | ISO/IEC 10165-2 : 1992":top;
CHARACTERIZED BY connectionP1 PACKAGE
BEHAVIOUR
connectionB1 BEHAVIOUR
DEFINED AS
!This managed object class represents the view of a
single-peer connection between a pair of entities as seen
by the local entity.!;
;
ATTRIBUTES connectionId GET,
underlyingConnectionNames GET;
;;
REGISTERED AS {CommonMgt.moi connection(1003)};
-- Connectionless-mode Protocol Machine
-- Summary of changes to 10165-5:
-- 1. Added CCITT part to document references.
-- 2. Did not register mandatory package.
-- 3. Changed name of naming attribute to clProtocolMachineId.
-- 4. Removed DEFAULT VALUE and REQUIRED VALUES on naming attribute.
-- 5. Generalised description.
clProtocolMachine MANAGED OBJECT CLASS
DERIVED FROM "Rec. X.721 | ISO/IEC 10165-2 : 1992":top;
CHARACTERIZED BY clProtocolMachineP1 PACKAGE
BEHAVIOUR
clProtocolMachineB1 BEHAVIOUR
DEFINED AS
!A protocol machine which performs connectionless-mode
communications functions.!;
;
ATTRIBUTES clProtocolMachineId GET,
"Rec. X.721 | ISO/IEC 10165-2 : 1992":operationalState GET;
;;
REGISTERED AS {CommonMgt.moi clProtocolMachine(1004)};
-- Connection-mode Protocol Machine
-- Summary of changes to 10165-5:
-- 1. Added CCITT part to document references.
-- 2. Did not register mandatory package.
-- 3. Changed name of naming attribute to coProtocolMachineId.
-- 4. Removed DEFAULT VALUE and REQUIRED VALUES on naming attribute.
-- 5. Generalised description.
coProtocolMachine MANAGED OBJECT CLASS
DERIVED FROM "Rec. X.721 | ISO/IEC 10165-2 : 1992":top;
CHARACTERIZED BY coProtocolMachineP1 PACKAGE
BEHAVIOUR
coProtocolMachineB1 BEHAVIOUR
DEFINED AS
!A protocol machine which performs connection-mode
communications functions.!;
;
ATTRIBUTES coProtocolMachineId GET,
"Rec. X.721 | ISO/IEC 10165-2 : 1992":operationalState GET;
;;
REGISTERED AS {CommonMgt.moi coProtocolMachine(1005)};
-- Sap 1
-- Summary of changes to 10165-5:
-- 1. Added CCITT part to document references.
-- 2. Gave plural label to set-valued attribute.
-- 3. Did not register mandatory package.
sap1 MANAGED OBJECT CLASS
DERIVED FROM "Rec. X.721 | ISO/IEC 10165-2 : 1992":top;
CHARACTERIZED BY sap1P1 PACKAGE
BEHAVIOUR
sap1B1 BEHAVIOUR
DEFINED AS
!This managed object represents the point at which an
entity provides services to the user entity. Refer to the
Basic Reference Model for the definition of (N)-sap.!;
;
ATTRIBUTES sapId GET,
sap1Address GET,
userEntityNames GET;
;;
REGISTERED AS {CommonMgt.moi sap1(1008)};
-- Sap 2
-- Summary of changes to 10165-5:
-- 1. Added CCITT part to document references.
-- 2. Gave plural labels to set-valued attributes.
-- 3. Did not register mandatory package.
sap2 MANAGED OBJECT CLASS
DERIVED FROM "Rec. X.721 | ISO/IEC 10165-2 : 1992":top;
CHARACTERIZED BY sap2P1 PACKAGE
BEHAVIOUR
sap2B1 BEHAVIOUR
DEFINED AS
!A service access point, the address of which is
independent of the SAP of the underlying layer.!;
;
ATTRIBUTES sapId GET,
sap2Addresses GET,
userEntityNames GET,
providerEntityNames GET;
;;
REGISTERED AS {CommonMgt.moi sap2(1009)};
-- Subsystem
-- Summary of changes to 10165-5:
-- 1. Added CCITT part to document references.
-- 2. Fixed typo in naming attribute.
-- 3. Did not register mandatory package.
subsystem MANAGED OBJECT CLASS
DERIVED FROM "Rec. X.721 | ISO/IEC 10165-2 : 1992":top;
CHARACTERIZED BY subsystemP1 PACKAGE
BEHAVIOUR
subsystemB1 BEHAVIOUR
DEFINED AS
!This managed object class represents a portion of a
system where components are named independently of the
components of other subsystems.!;
;
ATTRIBUTES subsystemId GET;
;;
REGISTERED AS {CommonMgt.moi subsystem(1010)};
--
-- Attributes
clProtocolMachineId ATTRIBUTE
WITH ATTRIBUTE SYNTAX CommonMgt.ProtocolMachineId;
MATCHES FOR EQUALITY;
REGISTERED AS {CommonMgt.aoi clProtocolMachineId(1051)};
communicationsEntityId ATTRIBUTE
WITH ATTRIBUTE SYNTAX CommonMgt.CommunicationsEntityId;
MATCHES FOR EQUALITY;
REGISTERED AS {CommonMgt.aoi communicationsEntityId(1003)};
informationData ATTRIBUTE
WITH ATTRIBUTE SYNTAX CommonMgt.InformationData;
REGISTERED AS {CommonMgt.aoi informationData(1052)};
informationType ATTRIBUTE
WITH ATTRIBUTE SYNTAX CommonMgt.InformationType;
MATCHES FOR EQUALITY;
REGISTERED AS {CommonMgt.aoi informationType(1053)};
connectionId ATTRIBUTE
WITH ATTRIBUTE SYNTAX CommonMgt.ConnectionId;
MATCHES FOR EQUALITY;
REGISTERED AS {CommonMgt.aoi connectionId(1004)};
coProtocolMachineId ATTRIBUTE
WITH ATTRIBUTE SYNTAX CommonMgt.ProtocolMachineId;
MATCHES FOR EQUALITY;
REGISTERED AS {CommonMgt.aoi coProtocolMachineId(1050)};
localSapNames ATTRIBUTE
WITH ATTRIBUTE SYNTAX CommonMgt.ProviderObjects;
-- Note: Not derived from DMI.providerobject as in 10165-5.
MATCHES FOR EQUALITY, SET-COMPARISON, SET-INTERSECTION;
REGISTERED AS {CommonMgt.aoi localSapNames(1007)};
nonWrappingCounter ATTRIBUTE
WITH ATTRIBUTE SYNTAX CommonMgt.NonWrappingCounter;
MATCHES FOR EQUALITY, ORDERING;
BEHAVIOUR
nonWrappingCounterB BEHAVIOUR
DEFINED AS
!Generic non-wrapping counter. Never instantiated - used
to derive specific non-wrapping counter attributes. All counters
derived from nonWrappingCounter shall have a mandatory initial value
of zero. The value of a counter attribute derived from this shall be
incremented by an amount as specified in the behaviour of the refined
attribute, and shall increase monotonically. It shall be implemented
in such a way that under all foreseable circumstances the upper bound
on its value shall not be limited to a value less than 2^64-1. This does not
require the system to maintain a 64-bit counter if the characteristics of the
implementation are such that all achievable count values can be contained
in a smaller number of bits.!;;
;-- Note, since this attribute is never instantiated, no object identifier
-- is registered.
providerEntityNames ATTRIBUTE
WITH ATTRIBUTE SYNTAX CommonMgt.ProviderObjects;
-- Note: Not derived from DMI.providerobject as in 10165-5.
MATCHES FOR EQUALITY, SET-COMPARISON, SET-INTERSECTION;
-- Note: The set-valued operations not specified in 10165-5.
REGISTERED AS {CommonMgt.aoi providerEntityNames(1011)};
sap1Address ATTRIBUTE
WITH ATTRIBUTE SYNTAX CommonMgt.Sap1Address;
MATCHES FOR EQUALITY;
REGISTERED AS {CommonMgt.aoi sap1Address(1013)};
sap2Addresses ATTRIBUTE
WITH ATTRIBUTE SYNTAX CommonMgt.Sap2Addresses;
MATCHES FOR EQUALITY, SET-COMPARISON, SET-INTERSECTION;
BEHAVIOUR sap2AddressesB BEHAVIOUR
DEFINED AS
!The set of addresses of a SAP.!;;
REGISTERED AS {CommonMgt.aoi sap2Addresses(1014)};
sapId ATTRIBUTE
WITH ATTRIBUTE SYNTAX CommonMgt.SapId;
MATCHES FOR EQUALITY;
REGISTERED AS {CommonMgt.aoi sapId(1015)};
timer ATTRIBUTE
WITH ATTRIBUTE SYNTAX CommonMgt.Timer;
MATCHES FOR EQUALITY, ORDERING;
BEHAVIOUR
timerB BEHAVIOUR
DEFINED AS
!A timer whose value may be set and read to the precision
implied by the syntax definition, but whose effect on the
precision with which the protocol events controlled by this
timer are generated is determined by the implementation. The
details of this precision shall be stated in the MOCS. The
exponent of the timer value shall be encoded as a decimal
exponent in the exponent field of the syntax, i.e. the value
of the timer shall be mantissa*10^exponent.!;;
;-- Note, since this attribute is never instaniated, no object identifier
-- is registered.
subsystemId ATTRIBUTE
WITH ATTRIBUTE SYNTAX CommonMgt.SubsystemId;
MATCHES FOR EQUALITY;
REGISTERED AS {CommonMgt.aoi subsystemId(1016)};
underlyingConnectionNames ATTRIBUTE
WITH ATTRIBUTE SYNTAX CommonMgt.ProviderObjects;
-- Note: Not derived from DMI.providerobject as in 10165-5.
MATCHES FOR EQUALITY, SET-COMPARISON, SET-INTERSECTION;
REGISTERED AS {CommonMgt.aoi underlyingConnectionNames(1019)};
userEntityNames ATTRIBUTE
WITH ATTRIBUTE SYNTAX CommonMgt.UserObjects;
-- Note: Not derived from DMI.userobject as in 10165-5.
MATCHES FOR EQUALITY, SET-COMPARISON, SET-INTERSECTION;
REGISTERED AS {CommonMgt.aoi userEntityNames(1020)};
-- Attribute groups
counters ATTRIBUTE GROUP
-- Empty group definition. Counters are added to the group in
-- package definitions.
DESCRIPTION
!The group of all counter attributes.!;
REGISTERED AS {CommonMgt.agoi counters(1001)};
-- Actions
activate ACTION
BEHAVIOUR activateB BEHAVIOUR
DEFINED AS
!Initializes the operation of the resource. As a result of the action,
the sequence of operations necessary to cause the resource to enter
its operational mode shall be initiated. These may include, for example,
checks against attribute constraint violation and checks on the validity of
relationship attributes (cross-layer and other). If these operations are
successfully initiated, the administrative state (if present) shall be
changed to 'unlocked' and the value 'successResponse' shall be
returned in the responseCode parameter of the action reply. If these
operations cannot be successfully initiated, the value
'failureResponse' shall be returned,together with a failure reason
parameter describing the reason for the failure.
On successful completion of these operations, the operational state
shall have the value 'enabled'.
Depending on the current state of the resource, some or all of the
above operations may be unneccessary.!;;
MODE CONFIRMED;
WITH REPLY SYNTAX CommonMgt.ActionReply;
REGISTERED AS {CommonMgt.acoi activate(1001)};
deactivate ACTION
BEHAVIOUR deactivateB BEHAVIOUR
DEFINED AS
!Terminates the operation of the resource. As a result of the
action the sequence of operations necessary to cause the resource
to cease operation shall be initiated. If these operations are
successfully initiated, the administrative state (if present) shall
be changed to 'locked' and the value 'successResponse' shall be
returned in the responseCode parameter of the action reply. If
these operations cannot be successfully initiated, the value
'failureResponse' shall be returned,together with a failure reason
parameter describing the reason for the failure.
On completion of these operations, the operational state shall have
the value 'disabled'.
Depending on the current state of the resource, some or all of the
above operations may be unneccessary.!;;
MODE CONFIRMED;
WITH REPLY SYNTAX CommonMgt.ActionReply;
REGISTERED AS {CommonMgt.acoi deactivate(1002)};
shutdown ACTION
BEHAVIOUR shutdownB BEHAVIOUR
DEFINED AS
!Shuts down the operation of the resource. If at the time, the
resource has existing users, the administrative state shall become
'shutting down', and no new users of the resource shall be
permitted. The value 'successResponse' shall be returned in the
responseCode parameter of the action reply. If the resource cannot
be shut down the value 'failureResponse' shall be returned,together
with a failure reason parameter describing the reason for the
failure.
When, subsequently, the number of existing users drops to zero,
the sequence of operations necessary to cause the resource to cease
operation shall be initiated. The administrative state shall be
changed to 'locked'. When these operations are completed the
operational state shall become 'disabled'.
If at the time the resource has no existing users, the sequence of
operations necessary to cause the resource to cease operation shall
be initiated. he administrative state shall be changed to 'locked'.
The value 'successResponse' shall be returned in the responseCode
parameter of the action reply. If the resource cannot be shut down
the value 'failureResponse' shall be returned,together with a
failure reason parameter describing the reason for the failure.
When the operations initiated above are completed the operational
state shall become 'disabled'.
Depending on the current state of the resource, some or all of the
above operations may be unneccessary.!;;
MODE CONFIRMED;
WITH REPLY SYNTAX CommonMgt.ActionReply;
REGISTERED AS {CommonMgt.acoi shutdown(1003)};
-- Notifications
communicationsInformation NOTIFICATION
BEHAVIOUR communicationsInformationB BEHAVIOUR
DEFINED AS
!This notification may be used to report the occurence of
events pertaining to the normal operation of a managed object.
These are informational events; important enough to report, but
not requiring any further action by a manager. Faults and
abnornal conditions (which may require manager action) shall be
reported using the event types defined in
Rec.X.733 | ISO/IEC 10164-4.!;;
WITH INFORMATION SYNTAX CommonMgt.CommunicationsInformation
AND ATTRIBUTE IDS
informationType informationType,
informationData informationData;
REGISTERED AS {CommonMgt.noi communicationsInformation(1001)};
-- Functional unit packages
-- The following object identifier
-- {CommonMgt.fupoi informationEventReports(1000)}
-- is assigned as a value of the ASN.1 type FunctionalUnitPackageId
-- defined in CCITT Rec.X.701 | ISO/IEC 10040 to use for negotiating
-- use of the following functional unit
-- 0 communication information functional unit
--
-- where the number identifies the bit position assigned to the
-- functional unit.
END
-- ASN.1 definitions
CommonMgt {joint-iso-ccitt network-layer(13) management(0) sc6-gmi(0)
asn1Module(2) 0}
DEFINITIONS IMPLICIT TAGS ::= BEGIN
-- EXPORTS everything
-- "infrastructure" object identifier definitions
cmoi OBJECT IDENTIFIER ::= {joint-iso-ccitt network-layer(13) management(0) sc6-gmi(0)}
sseoi OBJECT IDENTIFIER ::= {cmoi standardSpecificExtensions(0)}
fupoi OBJECT IDENTIFIER ::= {cmoi functionalUnitPackage(1)}
moi OBJECT IDENTIFIER ::= {cmoi managedObjectClass(3)}
poi OBJECT IDENTIFIER ::= {cmoi package(4)}
proi OBJECT IDENTIFIER ::= {cmoi parameter(5)}
aoi OBJECT IDENTIFIER ::= {cmoi attribute(7)}
agoi OBJECT IDENTIFIER ::= {cmoi attributeGroup(8)}
acoi OBJECT IDENTIFIER ::= {cmoi action(9)}
noi OBJECT IDENTIFIER ::= {cmoi notification(10)}
-- other definitions
ActionInfo ::= SET OF Parameter
ActionReply ::= SEQUENCE{
responseCode OBJECT IDENTIFIER,
responseArgs SET OF Parameter OPTIONAL}
counterInitialValue NonWrappingCounter ::= 0
InformationData ::= SET OF Parameter
CommunicationsInformation ::= SEQUENCE{
informationType InformationType,
informationData InformationData OPTIONAL}
InformationType ::= OBJECT IDENTIFIER
CommunicationsEntityId ::= GraphicString
ConnectionId ::= GraphicString
failureResponse OBJECT IDENTIFIER ::= {responseCode failureResponse(1001)}
informationEventReports OBJECT IDENTIFIER ::= {fupoi
informationEventReports(1000)}
NonWrappingCounter ::= Integer(0..18446744073709551616) -- (0..2^64-1)
NotificationInfo ::= SET OF Parameter
Parameter ::= SEQUENCE{
paramId OBJECT IDENTIFIER,
paramInfo ANY DEFINED BY paramId}
ProtocolMachineId ::= GraphicString
ProviderObjects ::= SET OF CMIP-1.BaseManagedObjectId
-- only the localDistinguishedName form of ObjectInstance is used
responseCode OBJECT IDENTIFIER ::= {proi responseCode(1001)}
-- value assignments for specific action response codes are registered
-- under this OID.
ResponseCode ::= OBJECT IDENTIFIER
Sap1Address ::= Integer
Sap2Addresses ::= SET OF OctetString
SapId ::= GraphicString
SubsystemId ::= GraphicString
successResponse OBJECT IDENTIFIER ::= {responseCode successResponse(1002)}
Timer ::= Sequence{
exponent [1] INTEGER(-62..63),
mantissa [2] INTEGER(0..65535)}
UserObjects ::= SET OF CMIP-1.BaseManagedObjectId
-- only the localDistinguishedName form of ObjectInstance is used
END